home *** CD-ROM | disk | FTP | other *** search
/ 3D Images / 3D Images.iso / programs / amiga / tree4d / tree_4d_docs < prev    next >
Text File  |  1995-01-12  |  8KB  |  192 lines
  1. December 1991          Tree 4D v1.5
  2.                        ------------
  3.  
  4.  Copyright 1991 Bruce Thomson
  5.  DISCLAIMER
  6.  No guarantee is made, expressed or implied as to Tree_4D's
  7. suitability for any application.  No responsibility will be taken by
  8. the author for any results of its use or misuse.
  9.  
  10.  This is Shareware.  If you use this program or any of my other sculpt
  11. tools then please send some cash.  I recommend $US10 but any amount
  12. whatsoever is acceptable.  No, I draw the line at coinage.
  13.                          LIMITATION
  14.  This version will create trees with branches, sub-branches and
  15. leaves.  If you would like a version which allows for more detailed
  16. and intricate trees send $US10.
  17.  
  18.  
  19. Tree 4D creates 3D branching trees with leaves, as objects for
  20. Sculpt 4D.  The trees are made of branches splitting off from a trunk,
  21. with branches having sub-branches etc.  Branches on the final level
  22. may have leaves.  Many details of the tree can be altered to give a
  23. wide variation of final results.  The following can be set by the
  24. user:
  25. - Branch length and variation
  26. - Branch angle and variation
  27. - Branch radii
  28. - Number of sub-branches per branch
  29. - Colour of branches
  30. - Detail of branches 
  31. The same applies to the leaves.
  32.  
  33.  
  34. Tree_4D can run from Workbench or CLI and needs around 150K of
  35. memory free.  A copy of 'req.library' should be present in your LIBS:
  36. directory.
  37. Trees are formed by arranging the branches or leaves spread
  38. equally around a circle at each branching point, and then angled
  39. according to the settings.
  40.  
  41. Controls
  42. --------
  43.  
  44.   Use the gadgets to select which type of tree you would like created.
  45. The settings will be stored between creation of several trees so you
  46. can alter single settings to fine-tune a tree.  With string gadgets if
  47. a decimal place is shown as part of the default value then you can use
  48. fractional values.  If only an integer is shown then only integers
  49. will be acceptable.
  50.  
  51. -  Seed value.
  52.   This is an integer from 0 to 9999.  This sets the random number
  53. generator.  If you want to recreate a particular tree then you must
  54. record this number along with the other settings.  To get trees that
  55. look different alter this value.
  56.  
  57. - Tree with branches/sub-branches gadget.
  58.    This will toggle between creating trees with branches only or
  59.    branches and sub-branches.
  60.  
  61. - Modify the branch settings
  62.   Takes you to another window to set branch values.
  63.  
  64. - Change Tree Colours
  65.   The branches and trunk are all of one colour and the leaves are all
  66.  of another colour.  You are able to alter which each of these colours
  67.  are.  Although the screen colours return to what they were originally
  68.  after you have altered the brown and green default colours for the
  69.  branches and leaves, respectively, your colours will be stored
  70.  internally and used in future trees until you change the colours
  71.  again.
  72.  
  73. - Generate scene.
  74.   This gadget will prompt you to enter a filename for the scene to be
  75.   named as (with a '.scene' automatically appended)
  76.  
  77. - Quit.
  78.   
  79.  
  80.   There are some defaults for the design of the branches.  They will
  81. generate a standard tree.  Any of the settings can be changed but
  82. there are many settings and you may be satisfied with the ones used to
  83. generate a previous tree, or with the defaults if this is the first
  84. tree to be made.
  85.  
  86.   If you modify the branches you can alter:
  87. - Trunk height factor.
  88.  If you would like the trunk to be taller or shorter than normal
  89.  then alter this setting.  This allows the turnk to be a
  90.  significantly different length to the branches without needing to
  91.  set the branch length multiplier below.  Use 1.0 to leave trunk at
  92.  default height.
  93.  
  94. - Trunk shape. 
  95.  This is used to set the ratio of height to width of the trunk.
  96.  If you would like a skinny looking tree then make this value
  97.  greater.
  98.  
  99. - Minimum and maximum branches at each branching point.
  100.   These will determine the number of branches and sub-branches to
  101.  create at each branching point.  A number between minimum and
  102.  maximum will be selected at random.  Lower bound can be zero, but
  103.  you may have to create a few trees until you find one with an
  104.  acceptable number of branches.  Upper bound of 10.
  105.  
  106. -Branch angle & Branch angle Multiplier.
  107.    These two will set the general look of the tree, from flat and
  108.  bushy to tall and narrow.  Branch angle is the angle that the first
  109.  set of branches will take, measured from the vertical.  Thus a value
  110.  of zero will make all branches point straight up, and 90 will point
  111.  all branches straight out.  
  112.   The multiplier alters how any future levels of sub-branching will
  113.  be angled.  A value of one means all branches and sub-branches are
  114.  at the same angle, a value less than one means the sub-branches
  115.  become less spread out, the tree becomes denser, and a value greater
  116.  than one increases the spread.
  117.  
  118. - Branch angle variation.
  119.    This is used to give the tree a more natural look.  The branching
  120.  angles can vary for each branch.  The final angle is: Standard Angle
  121.  For This Level * (1+/- random*angle variation)
  122.  
  123. - Branch length multiplier.
  124.    Each level of branches has a length that should generally shorten
  125.  as trunk goes to branch to twig etc.  This value alters the length
  126.  of the current level of branches to be multiplier*previous length.
  127.  
  128. - Branch length variation operates in a similar fashion to angle
  129.  variation above.
  130.  
  131. - Branch detail.
  132.   The branches are made of tubes, with branches on the final level
  133.  created having the ends filled as in cylinders.  This value is the
  134.  equivalent of Sculpt's  subdivision level when creating tubes,
  135.  circles, cylinders etc.  The higher it is the more faces will be
  136.  created, and the smoother the branches will look.
  137.  
  138. - Branch radius multiplier.
  139.  The radius of the branches can be modified independently of the
  140.  lengths of the branches.  The trunk radius relative to length is set
  141.  in the 'Trunk shape' value above.  The radius of the trunk will be
  142.  multiplied by the value for the radius multiplier to give the radius
  143.  of the first set of branches.  This will be multiplied again to get
  144.  the radius of the second set etc.
  145. -  Reset settings to default 
  146.    Will return the branch settings back to a set of reasonable
  147.  defaults if you think you have mucked it up.
  148. -  Done.
  149.    Return back to the main window.
  150.  
  151.  
  152. Modify the leaf settings
  153.   These settings generally mirror those for the branches.
  154. - Minimum and Maximum number of leaves
  155.  The number of leaves to appear on each branch at the final branching
  156.  level.  A random number between the two will be selected.  These will
  157.  be evenly spaced around the end of the branch.
  158.  
  159. - Leaf detail.  Leaves are filled ovals.  This value is the
  160.  equivalent of Sculpt's subdivision level when creating circles.
  161.  
  162. - Leaf angle and variation are the same as for branches.
  163. - Leaf size factor and Variation.
  164.  These modify how large the leaves are in comparision to the
  165.  branches.  A value for size factor greater than one will make leaves
  166.  that are larger than normal.  Variation will make some leaves
  167.  smaller or larger than normal.  This is the same as other variations
  168.  above.
  169. - Leaf shape
  170.   This is a ratio of the length of the leaves to the width.  A value
  171.  of 1 will give circular leaves, a value of 2 will give long leaves.
  172.  Use this with the leaf size setting.
  173.  
  174.  
  175.   After you click on 'Generate Scene' from the main window, you
  176. will be shown the number of branches and leaves, the number of
  177. vertices, edges and faces in the object and total scene size.  Now you
  178. enter a filename to save the tree under.  If you are unhappy with the
  179. final size of the object Cancel the file requester and try again with
  180. a tree with fewer branches, fewer leaves, less detail or just a
  181. different random seed.
  182.  
  183.   Problems, questions,suggestions, money (cash preferred to avoid bank
  184. fees to us all, but preferably register it) can be sent to:
  185.  
  186. Bruce Thomson
  187. PO Box 33116
  188. Takapuna
  189. Auckland
  190. New Zealand.
  191.  
  192.